<?php

/**
 *
 * @SWG\Get(
 *     path="/get_user_info",
 *     tags={"user"},
 *     summary="获取自己的用户数据",
 *     description="获取自己的用户数据（成功示例请执行）",
 *     produces={"application/json"},
 *     @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *
 *     @SWG\Response(
 *         response = 200,
 *         description = "success",
 *         @SWG\Schema(ref="#/definitions/SuccessDefault")
 *     ),
 *
 *     @SWG\Response(
 *         response = 400,
 *         description = "请求失败， http code 强行转为200,通过code判断",
 *         @SWG\Schema(ref="#/definitions/ErrorDefault")
 *     )
 * )
 */


/**
 *
 * @SWG\Get(
 *     path="/user/list",
 *     tags={"user"},
 *     summary="用户列表",
 *     description="获取用户列表（成功示例请执行）",
 *     produces={"application/json"},
 *     @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *
 *     @SWG\Response(
 *         response = 200,
 *         description = "success",
 *         @SWG\Schema(ref="#/definitions/SuccessDefault")
 *     ),
 *
 *     @SWG\Response(
 *         response = 400,
 *         description = "请求失败， http code 强行转为200,通过code判断",
 *         @SWG\Schema(ref="#/definitions/ErrorDefault")
 *     )
 * )
 */


/**
 * --- .user.change-password start ---
 * @SWG\Post(
 *    path="/user/change-password",
 *    tags={"user"},
 *    summary="用户自己修改密码",
 *    description="用户自己修改密码",
 *    consumes={"application/x-www-form-urlencoded"},
 *    produces={"application/json", "application/xml"},
 *    security={{"api_key":{}}},
 *     @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *    @SWG\Parameter(
 *        name = "password",
 *        description = "旧密码",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *
 *    @SWG\Parameter(
 *        name = "newpassword",
 *        description = "新密码",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *      @SWG\Parameter(
 *        name = "repassword",
 *        description = "确认新密码",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *
 *    @SWG\Response(
 *        response = "200",
 *        description = "success",
 *        @SWG\Schema(ref="#/definitions/SuccessDefault")
 *    ),
 *
 *    @SWG\Response(
 *        response = "default",
 *        description = "请求失败， http status 强行转为200, 通过code判断",
 *        @SWG\Schema(ref="#/definitions/ErrorDefault")
 *    )
 * )
 * --- .user.change-password end ---
 */


/**
 *
 * @SWG\Get(
 *     path="/user/reset-password/{user_id}",
 *     tags={"user"},
 *     summary="管理员重置用户密码",
 *     description="管理员重置用户密码（默认密码123456qweasd）",
 *     produces={"application/json"},
 *     @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *     @SWG\Parameter(
 *        in = "path",
 *        name = "user_id",
 *        description = "用户id",
 *        required = true,
 *        type = "string"
 *     ),
 *
 *     @SWG\Response(
 *         response = 200,
 *         description = "success",
 *         @SWG\Schema(ref="#/definitions/SuccessDefault")
 *     ),
 *
 *     @SWG\Response(
 *         response = 400,
 *         description = "请求失败， http code 强行转为200,通过code判断",
 *         @SWG\Schema(ref="#/definitions/ErrorDefault")
 *     )
 * )
 */



/**
 * --- .add user start ---
 *
 * @SWG\Post(
 *    path="/user/add",
 *    tags={"user"},
 *    summary="添加用户",
 *    description="添加用户",
 *    produces={"application/json"},
 *    consumes={"application/x-www-form-urlencoded", "application/json"},
 *
 *    @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *
 *    @SWG\Parameter(
 *        name = "username",
 *        description = "账号",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *
 *    @SWG\Parameter(
 *        name = "password_hash",
 *        description = "密码",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *
 *    @SWG\Parameter(
 *        name = "gender",
 *        description = "姓别",
 *        in = "formData",
 *        type = "integer",
 *        required = true
 *    ),
 *    @SWG\Parameter(
 *        name = "roles",
 *        description = "角色，目前只给角色['超级管理员','管理员','监视用户']",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *    @SWG\Parameter(
 *        name = "line_ids",
 *        description = "线路id集合，复选，[数组] [1,2,3...]",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *
 *    @SWG\Response(
 *        response = "200",
 *        description = "success",
 *        @SWG\Schema(ref="#/definitions/SuccessDefault")
 *    ),
 *
 *    @SWG\Response(
 *        response = "default",
 *        description = "请求失败， http status 强行转为200, 通过code判断",
 *        @SWG\Schema(ref="#/definitions/ErrorDefault")
 *    )
 * )
 * --- .add user  end ---
 */

/**
 * --- .edit user start ---
 *
 * @SWG\Post(
 *    path="/user/edit",
 *    tags={"user"},
 *    summary="编辑用户",
 *    description="编辑用户",
 *    produces={"application/json"},
 *    consumes={"application/x-www-form-urlencoded", "application/json"},
 *
 *    @SWG\Parameter(
 *        in = "header",
 *        name = "X-Api-Token",
 *        description = "token",
 *        required = true,
 *        type = "string"
 *     ),
 *
 *     @SWG\Parameter(
 *        name = "id",
 *        description = "id",
 *        in = "formData",
 *        type = "integer",
 *        required = true
 *    ),
 *
 *    @SWG\Parameter(
 *        name = "gender",
 *        description = "姓别",
 *        in = "formData",
 *        type = "integer",
 *        required = false
 *    ),
 *    @SWG\Parameter(
 *        name = "roles",
 *        description = "角色，目前只给角色['超级管理员','管理员','监视用户']",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *    @SWG\Parameter(
 *        name = "line_ids",
 *        description = "线路id集合，复选，[数组] [1,2,3...]",
 *        in = "formData",
 *        type = "string",
 *        required = true
 *    ),
 *     @SWG\Parameter(
 *        name = "status",
 *        description = "状态 1可用 -1删除",
 *        in = "formData",
 *        type = "integer",
 *        required = false
 *    ),
 *
 *    @SWG\Response(
 *        response = "200",
 *        description = "success",
 *        @SWG\Schema(ref="#/definitions/SuccessDefault")
 *    ),
 *
 *    @SWG\Response(
 *        response = "default",
 *        description = "请求失败， http status 强行转为200, 通过code判断",
 *        @SWG\Schema(ref="#/definitions/ErrorDefault")
 *    )
 * )
 * --- .edit user  end ---
 */

